Skip to content

Clarify role_ids and published_states in API docs#12236

Open
Parthsuii wants to merge 1 commit intoIQSS:developfrom
Parthsuii:patch-4
Open

Clarify role_ids and published_states in API docs#12236
Parthsuii wants to merge 1 commit intoIQSS:developfrom
Parthsuii:patch-4

Conversation

@Parthsuii
Copy link
Contributor

@Parthsuii Parthsuii commented Mar 20, 2026

What this PR does / why we need it:
Updates the MyData API documentation to clarify that role_ids and published_states parameters can be used multiple times in a single query (e.g., &role_ids=1&role_ids=6).

Which issue(s) this PR closes:

Special notes for your reviewer:
I updated the curl example and added "Multiple parameters can be used" to the relevant parameter descriptions to match the existing documentation style for fq.

Suggestions on how to test this:
View the updated MyData section in the API Guide to ensure the examples and parameter notes are clear and correctly formatted.

Does this PR introduce a user interface change?:
No.

Is there a release notes update needed for this change?:
Yes: Clarified documentation for filtering by multiple roles and states in MyData API.

Additional documentation:
N/A

Updated API documentation to clarify usage of role_ids and published_states parameters.
@pdurbin pdurbin moved this to Ready for Triage in IQSS Dataverse Project Mar 20, 2026
@scolapasta scolapasta moved this from Ready for Triage to Ready for Review ⏩ in IQSS Dataverse Project Mar 24, 2026
@scolapasta scolapasta added the Size: 0.5 A percentage of a sprint. 0.35 hours label Mar 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Size: 0.5 A percentage of a sprint. 0.35 hours

Projects

Status: Ready for Review ⏩

Development

Successfully merging this pull request may close these issues.

Add more information to the documentation about how api/mydata/retrieve is called

3 participants